************

INTRODUCTION

************


This file describes how to set up and use the Perl wrapper code with Melissa DATA's Address Object.



*************

PREREQUISITES

*************


To make use of the Address Object Perl wrapper you will need:


* An installation of Perl. Wrappers have been tested with Perl 5.8 and Perl 5.10. 


* The Melissa DATA Address Object library and data files installed.


You will need to know the location of these items in order to install and run the java wrapper.

**********************
Wrapper compatibility
**********************

If the provided pre-compiled wrappers are not compatible with your environment, the necessary files for compilation can be found in the 'interfaces' folder of the object's main directory.
*************

Installation

*************


Copy the entire folder that contains this README.txt into a local directory on your computer.


*****

Setup

*****


Open BuildWrapper.sh for editing. Put in the paths to the address object library

(libmdAddr.so) and the perl CORE directory. After the paths have been correctly set,

run BuildWrapper.sh (sh BuildWrapper.sh) and mdAddrPerlWrapper.so will

be created. This step must be completed successfully to run the perl sample.


************

Dependencies

************


You will need to allow mdAddrPerlWrapper.so to find libmdAddr.so. You can do this by:


	1. Set LD_LIBRARY_PATH to the directory containing libmdAddr.so. 

		ex: Export LD_LIBRARY_PATH=/DQT/Current


	or


	2. Copy libmdAddr.so into the directory with mdAddrPerlWrapper.so.




**************************

Setting up the Sample Code

**************************


Open AddressSample.pl for editing. You must set the a license string that you receive from your Melissa Data

sales representative:

	$addrObj->SetLicenseString('License Here');


and also the path to the Address Object Data Files:

	$addrObj->SetPathToUSFiles('path');



***********************

Running the Sample Code

***********************


Navigate to the directory containing the perl wrapper using command line and type:

	'perl AddressSample.pl'


*******

Updates

*******


The wrapper does not have to be rebuilt for updates. Simply replace Address Object (libmdAddr.so) and the data files. However, if there is a new method, you will need to rebuild the wrapper to use it.



****

Note

****


Here are some general solutions if you run into problems:


Q. I get an error saying "libmdAddr.so: shared object cannot be opened ."

A. This means that mdAddrPerlWrapper.so cannot link to libmdAddr.so. Please following one of the steps in the Setup section above.

 

COPYRIGHT NOTICE


(C) 2009 Melissa Data Corporation. All rights reserved.

